<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<HTML LANG="EN-US">
<HEAD>
<TITLE>VT100.net: VT330/VT340 Programmer Reference Manual</TITLE>
<LINK HREF="vt330.css" TYPE="text/css" REL="stylesheet">
</HEAD>
<BODY>
<DIV CLASS="navbar"><A HREF="http://vt100.net/"><IMG CLASS="button" SRC="vt100.net-logo.png" ALT="VT100.net" HEIGHT="16" WIDTH="102"></A> VT330/VT340 Programmer Reference Manual Volume 2: Graphics Programming<TABLE WIDTH="100%">
<COL SPAN="3" WIDTH="33%">
<TBODY>
<TR>
<TD ALIGN="LEFT"><A HREF="chapter7.html">Chapter 7</A></TD>
<TD ALIGN="CENTER"><A HREF="contents.html">Contents</A></TD>
<TD ALIGN="RIGHT"><A HREF="chapter9.html">Chapter 9</A></TD>
</TR>
</TBODY>
</TABLE>
<HR></DIV>
<H1 ID="S8"><SPAN CLASS="chapnum">8</SPAN> Load Command</H1>
<H2 ID="S8.1">Using Your Own Character Sets</H2>
<P>The VT300 lets you designate up to four character sets to use in ReGIS. The
alphabet 0 set (A0) can have up to 192 characters, all others can have up to 96
characters. You assign and select these character sets by number.</P>
<TABLE CLASS="dpadded">
<THEAD>
<TR>
<TH>Number</TH>
<TH>Character Set</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN="TOP">
<TD>0</TD>
<TD>Any one of the terminal's built-in sets (such as ASCII or ISO Latin-1 supplemental graphic)</TD>
</TR>
<TR VALIGN="TOP">
<TD>1 to 3</TD>
<TD>Up to three sets that you load into the terminal from the host system</TD>
</TR>
</TBODY>
</TABLE>
<P>You use the load command to select, load, or reload sets 1, 2, and 3. You cannot
use the load command to load character set 0. Set 0 is reserved for one of
the terminal's built-in sets. See <A HREF="chapter7.html">Chapter 7</A> for information on loading built-in
character sets.</P>
<P>There are three options to the load command.</P>
<TABLE CLASS="dpadded">
<TBODY>
<TR VALIGN="TOP">
<TD>Select character set</TD>
<TD>Assigns a number to the set you want to load.</TD>
</TR>
<TR VALIGN="TOP">
<TD>Specify name</TD>
<TD>Assigns a name to the set selected with the select character set option.</TD>
</TR>
<TR VALIGN="TOP">
<TD>Load character cell</TD>
<TD>Loads a character into the set selected with the select character set option.</TD>
</TR>
</TBODY>
</TABLE>
<H2 ID="S8.2">Select Character Set</H2>
<P>You use this option to assign a number to a character set you want to load into
the terminal. You can select 1, 2, or 3. You use the following format for the
select character set option.</P>
<P CLASS="example">L(A&lt;1 to 3&gt;)</P>
<P>where</P>
<DIV CLASS="example"><P><B>L</B> identifies a load command.</P>
<P><B>A</B> identifies a select character set option.</P>
<P><B>&lt;1 to 3&gt;</B> is a number to assign to a character set loaded from the host system.</P></DIV>
<P>After you select a character set number, you can use the other load command
options to name the character set and load the characters. All load commands
apply to the character set with this number, until you select another number.
However, you can use other types of ReGIS commands without affecting the
character set selected for loading.</P>
<P>You load characters into the character set by using the load character cell option.
You can load characters into the character set as needed. You do not have
to load the complete set at one time.</P>
<P CLASS="note">NOTE: You can select character set 0, but you cannot load it.</P>
<H2 ID="S8.3">Specify Name</H2>
<P>This option lets you specify a name for the character set selected with the select
character set option. You can use up to 10 characters in the name. You
use this name for report commands (<A HREF="chapter10.html">Chapter 10</A>), to report the name of the
currently selected loadable set. You use the following format for the specify
name option.</P>
<P CLASS="example">L(A'&lt;name&gt;')</P>
<P>where</P>
<DIV CLASS="example"><P><B>A</B> identifies a specify name option.</P>
<P><B>' '</B> are single or double quotation marks that enclose the character set name.</P>
<P><B>&lt;name&gt;</B> is a name to assign to the currently selected character set. You
can use up to 10 characters in the name.</P></DIV>
<P>You can use the specify name and select character set options together. That
is, you can assign the name and number of the character set at the same time.
Make sure you use the select character set option first in the command.
Otherwise, ReGIS assigns the name to the character set already selected, not
the character set you are selecting.</P>
<H2 ID="S8.4">Load Character Cell</H2>
<P>These arguments let you design and load a character into the terminal. ReGIS
loads the character into the set selected with the select character set option.
You use the following format for the load cell option.</P>
<P CLASS="example">L"&lt;character&gt;"&lt;hex pairs&gt;</P>
<P>where</P>
<DIV CLASS="example"><P><B>" "</B> are single or double quotation marks that enclose the call letter to use
for the character cell you are loading.</P>
<P><B>&lt;character&gt;</B> is one ASCII character to use as a call letter for the character
cell you are loading.</P>
<P><B>&lt;hex pairs&gt;</B> is a hexadecimal code that defines the appearance of the
character cell. You use a pair of hex values for each row of the cell (up to
10 rows).</P></DIV>
<P>First, you assign a call letter (&lt;character&gt;) to the cell. You use the <EM>call letter</EM>
to select the loaded character set in text commands. You can use any single ASCII
character for the call letter, including a number or space. However, there is
no relationship between the shape of the call letter and the character you
are loading.</P>
<P>Next, you define how the loaded character will look. Each character cell has 80
pixels in a 8 &times; 10 array. This size matches the unit cell size for a standard S1
character cell (<A HREF="chapter7.html#T7-1">Table 7-1</A>). You cannot define a character larger than the 8 &times; 10
array.</P>
<P>You use hexadecimal codes to define which pixels are on and off when you
display the character. <A HREF="#T8-1">Table 8-1</A> lists the bit pattern for each possible hex code.
A 1 bit turns a pixel on, and a 0 bit turns a pixel off. Each hex code defines a
4-bit pattern. You use two hex code values to define a row of 8 pixels. You
can define all 10 rows in the character cell.</P>
<TABLE ID="T8-1" CLASS="majortable">
<CAPTION>Table 8-1 Hex Code Table</CAPTION>
<COL SPAN="4">
<COL CLASS="lastcol">
<THEAD>
<TR VALIGN="BOTTOM">
<TH>Hex Code</TH>
<TH>Bit 1/5</TH>
<TH>Bit 2/6</TH>
<TH>Bit 3/7</TH>
<TH>Bit 4/8</TH>
</TR>
</THEAD>
<TBODY>
<TR>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
</TR>
<TR>
<TD>1</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>1</TD>
</TR>
<TR>
<TD>2</TD>
<TD>0</TD>
<TD>0</TD>
<TD>1</TD>
<TD>0</TD>
</TR>
<TR>
<TD>3</TD>
<TD>0</TD>
<TD>0</TD>
<TD>1</TD>
<TD>1</TD>
</TR>
<TR>
<TD>4</TD>
<TD>0</TD>
<TD>1</TD>
<TD>0</TD>
<TD>0</TD>
</TR>
<TR>
<TD>5</TD>
<TD>0</TD>
<TD>1</TD>
<TD>0</TD>
<TD>1</TD>
</TR>
<TR>
<TD>6</TD>
<TD>0</TD>
<TD>1</TD>
<TD>1</TD>
<TD>0</TD>
</TR>
<TR>
<TD>7</TD>
<TD>0</TD>
<TD>1</TD>
<TD>1</TD>
<TD>1</TD>
</TR>
<TR>
<TD>8</TD>
<TD>1</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
</TR>
<TR>
<TD>9</TD>
<TD>1</TD>
<TD>0</TD>
<TD>0</TD>
<TD>1</TD>
</TR>
<TR>
<TD>A</TD>
<TD>1</TD>
<TD>0</TD>
<TD>1</TD>
<TD>0</TD>
</TR>
<TR>
<TD>B</TD>
<TD>1</TD>
<TD>0</TD>
<TD>1</TD>
<TD>1</TD>
</TR>
<TR>
<TD>C</TD>
<TD>1</TD>
<TD>1</TD>
<TD>0</TD>
<TD>0</TD>
</TR>
<TR>
<TD>D</TD>
<TD>1</TD>
<TD>1</TD>
<TD>0</TD>
<TD>1</TD>
</TR>
<TR>
<TD>E</TD>
<TD>1</TD>
<TD>1</TD>
<TD>1</TD>
<TD>0</TD>
</TR>
<TR>
<TD>F</TD>
<TD>1</TD>
<TD>1</TD>
<TD>1</TD>
<TD>1</TD>
</TR>
</TBODY>
</TABLE>
<P>You build the cell from the top down. The first hex code value for a row
controls the pattern for the four left pixels. The second value controls the pattern
for the four right pixels.</P>
<P><STRONG>Example</STRONG></P>
<DIV><IMG SRC="inline8-1.png" ALT=""></DIV>
<P>If you use more than two hex values, ReGIS proceeds as if you used a comma
after each pair of values. If you use only one hex value or end up with one,
ReGIS assumes the first hex value is 0 and sets the first 4 bits in the row to 0
(off).</P>
<P>You do not have to define every row in a cell. However, you must define the
following rows.</P>
<UL>
<LI>Rows that have any pixels on</LI>
<LI>Blank rows that are above rows with pixels on</LI>
</UL>
<P>ReGIS assumes that any undefined rows at the bottom of the cell are blank.
<A HREF="#F8-1">Figure 8-1</A> shows some examples of loaded characters and their hex codes.</P>
<TABLE ID="F8-1" CLASS="figure" WIDTH="100%">
<CAPTION>Figure 8-1 Example of Load Character Cell Argument</CAPTION>
<COL ALIGN="CENTER">
<TBODY>
<TR>
<TD><IMG SRC="ma-0409-86.png" ALT=""></TD>
</TR>
<TR>
<TD><TABLE CLASS="command-example" FRAME="BORDER" RULES="GROUPS" CELLSPACING="0" CELLPADDING="8">
<COL ALIGN="CENTER">
<COL ALIGN="LEFT">
<TBODY>
<TR>
<TD COLSPAN="2" ALIGN="CENTER">COMMANDS</TD>
</TR>
</TBODY>
<TBODY>
<TR VALIGN="TOP">
<TD>&nbsp;<BR>(A)<BR>(B)<BR>(C)<BR>(D)<BR>(E)<BR>(F)</TD>
<TD>L(A3"alpha")<BR>"S" 00,14,3E,54,3E,15,3E,14<BR>
'c' 4,E,15,15,15,E,4<BR>
'C' FF,89,EB,81,E3,81,EB,89,FF<BR>
"b" 7F,41,41,41,41,49,55,55,55,63<BR>
'1' 0,1C,1C,1C,7F,3E,1C,8<BR>
"." 0,1F,8F,47,29,10,28,44,82;</TD>
</TR>
</TBODY>
</TABLE></TD>
</TR>
</TBODY>
</TABLE>
<H2 ID="S8.5">Load Command Summary</H2>
<P><A HREF="#T8-2">Table 8-2</A> is a summary of the <B>L</B> command options, including any default
values.</P>
<TABLE ID="T8-2" CLASS="summarytable" FRAME="VOID" RULES="GROUPS" CELLSPACING="0" CELLPADDING="4">
<CAPTION>Table 8-2 Load Command Summary</CAPTION>
<COL WIDTH="35%">
<COL WIDTH="20%">
<COL WIDTH="45%">
<THEAD>
<TR VALIGN="BOTTOM">
<TH>Option</TH>
<TH>Default</TH>
<TH>Description</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN="TOP">
<TD>(A&lt;1 to 3&gt;)</TD>
<TD>1</TD>
<TD><P><STRONG>Select character set</STRONG><BR>
Selects one of three loadable character sets to use for any following load commands.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(A"&lt;name&gt;")</TD>
<TD>" "</TD>
<TD><P><STRONG>Specify name</STRONG><BR>
Selects a name of up to 10 characters for the currently selected loadable character set. You can use this option with the select character set option:<BR>
(A&lt;1 to 3&gt;"&lt;name&gt;").</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>"&lt;ASCII&gt;"&lt;hex pairs&gt;</TD>
<TD>&#8211;</TD>
<TD><P><STRONG>Load character cell</STRONG><BR>
Loads a character into the currently selected loadable set.</P>
<TABLE CLASS="padded">
<TBODY>
<TR VALIGN="TOP">
<TD CLASS="first">&lt;ASCII&gt;</TD>
<TD>is an ASCII character you use to select the loadable character in other commands.</TD>
</TR>
<TR VALIGN="TOP">
<TD CLASS="first">&lt;hex&nbsp;pairs&gt;</TD>
<TD>define the bit pattern for each line of the character.</TD>
</TR>
</TBODY>
</TABLE></TD>
</TR>
</TBODY>
</TABLE>
<DIV CLASS="navbar"><HR>
<TABLE WIDTH="100%">
<COL SPAN="3" WIDTH="33%">
<TBODY>
<TR>
<TD ALIGN="LEFT"><A HREF="chapter7.html">Chapter 7</A></TD>
<TD ALIGN="CENTER"><A HREF="contents.html">Contents</A></TD>
<TD ALIGN="RIGHT"><A HREF="chapter9.html">Chapter 9</A></TD>
</TR>
</TBODY>
</TABLE>
<DIV CLASS="navbot">http://vt100.net/docs/vt3xx-gp/chapter8.html</DIV></DIV>
</BODY>
</HTML>
